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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.331 "Notification Log (NL) Integration Reference Point (IRP): Requirements". 

32.332 "Notification Log (NL) (NL) Integration Reference Point (IRP): Information Service (IS)". 

32.333 "Notification Log (NL) Integration Reference Point (IRP): Common Object Request Broker 
Architecture (CORE A) Solution Set (SS)". 

32.334 "Notification Log (NL) Integration Reference Point (IRP): Common Management Information 
Protocol (CMIP) Solution Set (SS)". 

32.335 "Notification Log (NL) Integration Reference Point (IRP): extensible Markup Language 
(XML) solution definitions". 

The present document is part of a TS-family, which describes the requirements and information model necessary for 
Telecommunications Management (TM). The TM principles and TM architecture are specified in 3GPP TS 32.101 [1] 
and 3GPPTS 32.102 [2]. 

A communications system is composed of a multitude of Network Elements (NE) of various types and, typically, 
different vendors, which inter-operate in a coordinated manner in order to satisfy the network users' communication 
requirements. 

The occurrence of faults in an NE may cause deterioration or loss of this NE's function. Fault Management is the 
functional area, which allows the operator to detect the occurrence of faults in the network in real-time. Configuration 
Management and Performance Management are two more functional areas, which require the operator to be alerted to 
certain conditions in the network. 

A standard general-purpose mechanism for the management of logs containing selected notifications from the network 
is required to provide an ability to perform historical analysis on faults and conditions, which occurred in the network. 
The documents series 32.33x, constituting the Notification Log IRP, sets forth such a mechanism - and the present 
document contains the relevant XML definition. 
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Scope 



The present document specifies the XML Definitions for the Notification Log Integration Reference Point (NL IRP) as 
it applies to Itf-N, in accordance with Notification Log IRP requirements (3GPP TS 32.331 [3]) and IS definitions 
(3GPPTS 32.331 [4]). 

This XML Definitions specification defines the XML syntax of the NL IRP XML Data File. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.331: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Requirements". 

[4] 3GPP TS 32.332: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Information Service (IS)". 

[5] 3GPP TS 32.342: "Telecommunication management; File Transfer (FT) Integration Reference 

Point (IRP); Information Service (IS)". 

[6] 3GPP TS 32.305: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): extensible Markup Language (XML) definitions". 

[7] 3GPP TS 32.1 1 1-5: "Telecommunication management; Fault Management; Part 5: Alarm 

Integration Reference Point (IRP): extensible Markup Language (XML) definitions". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
and 3GPP TS 32.331 [3] apply. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

IRP Integration Reference Point 

IS Information Service 

NL Notification Log 

UML Unified Modelling Language 
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IRP 

NRM 

XML 



Integration Reference Point 
Network Resource Model 
extensible Markup Language 



4 Structure and content of NL IRP XML 

The present clause defines the XML exchanged between an IRPManager and an IRP Agent as part of NL IRP IS (see 
3GPP TS 32.332 [4]): 

• the NL IRP XML Data File, 

• NL IRP notifications. 

The use of XML schemas ensures NL XML have the proper structure and to some extent the proper content, and in 
particular to ensure: 

for a given Notification instance, it is properly named/positioned with regard to the global naming tree; 

for a given Notification instance, only attributes of the corresponding Notification are present; 

for a given Notification attribute, its value is of the proper type. 

XML definitions for other application specific notifications (e.g. Alarm IRP notifications. Notification IRP Notification 
Header) are defined within the respective IRP series within specification 32.xy5. 



4.1 



Global structure 



Editor's Note: To be added in future version of this specification. 



4.2 XML elements fileHeader and fileFooter 

Editor's Note: To be added in future version of this specification. 



4.3 



NL IRP XML File Name Conventions 



For NL IRP XML File Name Conventions the generic file name definitions as specified by the FT IRP apply (see [5]). 

4.4 NL Interface IRP-specific XML schemas 

Interface IRP-specific XML schemas with definition of corresponding XML namespace prefixes are listed by the 
following table: 

Table 4.4: Interface IRP-specific XML schemas, corresponding 3GPP TSs and XML namespace 

prefixes 



IRP 


XML schema 


3GPP TS no. 


XML namespace prefix 


Alarm IRP 


alarmlRPnotif .xsd 


32.111-5 [7] 


xa 


Notification IRP 


notification .xsd 


32.305 [6] 


xe 


Notification Log IRP 


notificationLog.xsd 


32.335 


xl 



Each Interface IRP-specific XML schema explicitly declares Interface IRP-specific XML element types for the related 
Interface IRP. 
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Additionally, XML schema notification . xsd (see [06]) also provides global XML declarations and definitions 
for the support of: 

Notification header XML element type declaration 

4.5 NL IRP XML File Content Definitions 
4.5.1 NL IRP XIVIL Data File 

The structure of the Notification Log IRP XML Data File is shown in graphical depiction below: 
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o^7T7^i-(^)Eh 



nsl ilogFileVersion 



nsl : vendorlTaime 
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nsl ilogRecordId 
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Figure 4.5.1 : Structure of the Notification Log IRP XI\/IL Data File 

The notificationLogRecords element holds the instances of the notification records that are imported from the 
Notification Format XML schema. Note that Notification Header XML definitions are provided in [6]. 

The Notification Log IRP XML Data File is a simple instance based construct. The XML schema for the Notification 
Log IRP XML Data File is defined in Annex A. 

4.6 NL IRP Notification XML Definitions 

This clause provides XML definitions of Notification Log IRP notifications as defined in [4]. 
Editor's Note: To be added at a later stage. 
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Annex A (normative): 

Configuration data file base XIVIL schema 

(file name "notificationLog.xsd") 

<?xml version=" 1 . " encocling="UTF-8 " ?> 
<! — 

3GPP TS 32.335 Notification Log IRP 

3GPP Notification Log IRP XML Solution Definition, Schema Definition 
notificationLog.xsd 
— > 

<schema 

targetNamespace="http: //www. 3gpp. org/ ftp/ specs /archive /32_series/ 32 . 335#notif icationLog" 
e lementFormDe fault =" qualified" 
attributeFormDefault=" ungual if led" 
xmlns = "http: //www. w3 . org/2 00 1/XMLSchema" 

xmlns ; xe="http ; //www. 3gpp . org/ftp/specs/archive/32_series/32 . 305#notification" 
xmlns ; xa="http ; //www. 3gpp . org/ftp/specs/archive/32_series/32 . lll-5#alarmIRPNotif " 
> 

< import name space ="http ; //www. 3gpp . org/ftp/specs/archive/32_series/32 . 305#notification"/> 
<element name= "not if icationLog "> 
<complexType> 
<sequence> 

<element name="notif icationLogHeader" minOccurs="l" maxOccurs="l"> 
<complexType> 
<sequence> 

<element name="logFileVersion" type="string" minOccurs="l" 
maxOccurs=" 1 " /> 

<element name="vendorName" type="string" minOccurs="l" maxOccurs=" 1 " /> 
<element name="senderName" type="string" minOccurs="l" maxOccurs="l"/> 
</sequence> 
</complexType> 
</element> 

<element name="notif IcationLogRecords" minOccurs="0"> 
<complexType> 

<sequence minOccurs="0" maxOccurs="unbounded"> 
<element name="notif icationLogRecord"> 
<complexType> 
<sequence> 

<element name="logRecordId" type="string"/> 
<element ref="xe : Notification" /> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</complexType> 
</element> 
</schema> 
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Annex B (informative): 

NL IRP XIVIL Example Notification 



This annex provides an XML example notification, demonstrating the use of and the embedding into the NL IRP XML 
Notification Format. This example makes use of the Alarm IRP XML Schema for Notification. 

<?xml version=" 1.0" encoding="UTF-8 " ?> 

<notif icationLog xrnlns="http : //www. 3gpp . org/f tp/ specs /archive /32_series/ 32 . 335#notif icationLog" 

xmlns : xe="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 3 05#notif ication" 

xmlns : xsi="http : //www. w3 . org/2001/XMLSchema-instance" 

xsi : schemaLocation="http : //www. 3gpp . org/f tp/ specs /archive /32_series/ 32 . 335#not if icationLog 

Not if icationLog . xsd" > 

<notif icationLogHeader> 

<logFileVersion>32 .335 V6. 2</logFileVersion> 
<vendorName>Text</vendorName> 
<senderName>Text</senderName> 
</notif icationLogHeader> 
<notif icationLogRecords> 

<notif icationLogRecord> 

<logRecordId>1001</logRecordId> 

<xe : Notification xsi : type="Notif yNewSecurityAlarm" 
xmlns="http: //www. 3gpp. org/ftp/specs/archive/32_series/32 . 111-5 #alarmIRPNot if " 
xsi : schemaLocation="http : //www. 3gpp . org/f tp/ specs /archive /32_serie s/ 32 . lll-5#alarmIRPNotif 
alarmlRPNotif .xsd"> 

<xe : header> 

<xe : ob jectInstance>String</xe : object Inst ance> 
<xe:notificationId>21474 83 647</xe:notificationId> 
<xe:eventTime>200 1-12-17X0 9:30: 47. OZ</xe:eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe : header> 
<body> 

<probableCause>Indeterminate</probableCause> 
<perceivedSeverity>Critical</perceivedSeverity> 
<alarmType>Communi cat ions Alarm</alarmType> 
<correlatedNotif ications> 

<correlatedNotif ication> 

<source>String</source> 
<notif icationIdSet> 

<notificationId>21474 83 647</notificationId> 
</notif icationIdSet> 
</correlatedNotif ication> 
</correlatedNotif ications> 
<additionalText>String</additionalText> 
<additionalInf ormation>String</additionalInf ormation> 
<serviceUser>String</serviceUser> 
<serviceProvider>String</serviceProvider> 
<securityAlarmDetector>String</securityAlarmDetector> 
<alarmId>String</alarmId> 
</body> 
</xe : Notif ication> 
</notif icationLogRecord> 
<notif icationLogRecord> 

<logRecordId>String</logRecordId> 
<xe : Notification xsi : type="Notif yNewAlarm" 
xmlns="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . lll-5#alarmIRPNotif " 
xsi : schemaLocation="http : //www. 3gpp . org/f tp/ specs /archive /32_serie s/ 32 . lll-5#alarmIRPNotif 
alarmlRPNotif .XSD" > 

<xe : header> 

<xe : ob ject Instance>String</xe : ob ject Instance > 
<xe:notificationId>21474 83 647</xe:notificationId> 
<xe:eventTime>2 1-12-1710 9:30: 47. OZ</xe:eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe : header> 
<body> 

<probableCause>Indeterminate</probableCause> 
<perceivedSeverity>Critical</perceivedSeverity> 
<alarmType>Communi cat ions Alarm</alarmType> 
<specificProblem>String< /specif icProblem> 
<correlatedNotif ications> 

<correlatedNotif ication> 

<source>String</source> 
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<notif icationIdSet> 

<notificationId>21474 83 647</notificationId> 
</notificationIdSet> 
</correlatedNotif ication> 
</correlatedNotif ications> 
<backedUpStatus>true</backedUpStatus> 
<backupOb ject>String</backupOb ject> 
<trendIndication>Less Severe</trendIndication> 
<thresholdInfo> 

<attributeId>String</attributeId> 
<observedValue>3 . 14159E0</observedValue> 
<thresholdLevel> 

<indication>Up</indication> 
<low>3. 1415 9E0</low> 
<high>3 . 14159E0</high> 
</thresholdLevel> 

<armTime>2001-12-17T0 9 : 30:47. OZ</armTime> 
</thresholdInfo> 
<stateChangeDef inition> 
<stateValueChange> 

<attributeName>Administrative State</attributeName> 
<oldValue> 

<administrativeState>locked</administrativeState> 
</oldValue> 
<newValue> 

<administrativeState>unlocked</administrativeState> 
</newValue> 
</stateValueChange> 
<stateValueChange> 

<attributeName>Usage State</attributeName> 
<oldValue> 

<usageState>idle</usageState> 
</oldValue> 
<newValue> 

<usageState>busy</usageState> 
</newValue> </stateValueChange> 

</stateChangeDef inition> 
<monitoredAttributes> 
<attribueValue> 

<attributeName>String</attributeName> 
<attributeValue>Text</attributeValue> 
</attribueValue> 
</monitoredAttributes> 

<proposedRepairAct ions > St ring</proposedRepairAct ions > 
<additionalText>String</additionalText> 
<additional I nformation> St ring</ additional I nformation> 
<alarmId>String</alarmId> 
</body> 
</xe :Notif ication> 
</notif icationLogRecord> 
<notif icationLogRecord> 
<logRecordId/> 

<xe: Notification xsi; type="Notif yAckStateChanged" 
xmlns="http ; //www. 3gpp . org/ftp/specs/archive/32_series/32 . lll-5#alarmIRPNotif " 
xsi : schemaLocation="http ; //www. 3gpp . org/ftp/specs/archive/32_series/32 . lll-5#alarmIRPNotif 
alarmlRPNotif .xsd"> 

<xe : header> 

<xe:objectInstance>String</xe; object Instance> 
<xe:notificationId>21474 83647</xe:notificationId> 
<xe:eventTime>200 1-12-1710 9:30: 47. OZ</xe:eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe : header> 
<body> 

<probableCause>Indeterminate</probableCause> 
<perceivedSeverity>Critical</perceivedSeverity> 
<alarmType>Conimunications Alarm</alarmType> 
<alarmId>String</alarmId> 
<ackState>Acknowledged</ackState> 
<ackUserId>String</ackUserId> 
<ackSystemId>String</ackSystemId> 
</body> 
</xe:Notification> 
</notif icationLogRecord> 
<notif icationLogRecord> 
<logRecordId/> 
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<xe : Notification xsi : type="NotifyAlarmListRebuilt " 
xmlns="http : //www. 3gpp . org/f tp/ specs /archive / 3 2_series/ 32 . lll-5#alarmIRPNotif " 
xsi : schemaLocation="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . lll-5#alarmIRPNotif 
alarmlRPNotif .xsd"> 

<xe : header> 

<xe : ob ject Instance > St ring</xe : ob ject Instance > 
<xe:notificationId>21474 83647</xe:notificationId> 
<xe:eventTime>2001-12-17T0 9:30:47. OZ</xe : eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe : header> 
<body> 

<reason> 

<p re defined> Agent NE Communications Error</predef ined> 
</reason> 

<alarmListAlignmentRequirement>Alignment 
Required</alarmListAlignmentRequirement> 
</body> 
</xe :Notif ication> 
</notif icationLogRecord> 
<notif icationLogRecord> 
<logRecordId/> 

<xe : Notification xsi : type="Notif yChangedAlarm" 
xmlns="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . lll-5#alarmIRPNotif " 
xsi : schemaLocation="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . lll-5#alarmIRPNotif 
alarmlRPNotif .xsd"> 

<xe :header> 

<xe :objectInstance>String</xe: object Inst ance> 
<xe:notificationId>21474 83 647</xe:notificationId> 
<xe:eventTime>2001-12-17T09:30:47. OZ</xe : eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe : header> 
<body> 

<probableCause>Indeterminate</probableCause> 
<perceivedSeverity>Critical</perceivedSeverity> 
<alarmType>Communications Alarm</alarmType> 
<alarmId>String</alarmId> 
</body> 
</xe : Notif ication> 
</notif icationLogRecord> 
<notif icationLogRecord> 
<logRecordId/> 

<xe : Notification xsi : type="Notif yClearedAlarm" 
xmlns="http : //www. 3gpp . org/f tp/specs/archive/32__series/32 . lll-5#alarmIRPNotif " 
xsi : schemaLocation="http : //www. 3gpp . org/f tp/ specs /archive / 3 2_series / 32 . lll-5#alarmIRPNotif 
alarmlRPNotif .xsd"> 

<xe : header> 

<xe:objectInstance>String</xe: object Inst ance> 
<xe:notificationId>21474 83 647</xe:notificationId> 
<xe:eventTime>2001-12-17T09:30:47. OZ</xe : eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe : header> 
<body> 

<probableCause>Indeterminate</probableCause> 
<perceivedSeverity>Critical</perceivedSeverity> 
<alarmType>Communi cat ions Alarm</alarmType> 
<correlatedNotif ications> 

<correlatedNotif ication> 

<source>String</source> 
<notif icationIdSet> 

<notificationId>21474 83 647</notificationId> 
<notificationId>21474 83 647</notificationId> 
</notif icationIdSet> 
</correlatedNotif ication> 
<correlatedNotif ication> 

<source>String</source> 
<notif icationIdSet> 

<notificationId>21474 83 647</notificationId> 
<notificationId>21474 83 647</notificationId> 
</notif icationIdSet> 
</correlatedNotif ication> 
</correlatedNotif ications> 
<clearUserId>String</clearUserId> 
<clearSystemId>String</clearSystemId> 
<alarmId>String</alarmId> 
</body> 
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</xe :Notif ication> 
</notif icationLogRecord> 
<notif icationLogRecord> 
<logRecordId/> 

<xe : Notification xsi : type="NotifyComments" 
xmlns="http ; //www. 3gpp . org/ ftp/ specs /archive /32_series/ 32 . lll-5#alarmIRPNotif " 
xsi : schemaLocation="http ; //www. 3gpp . org/ftp/specs/archive/32_series/32 . lll-5#alarmIRPNotif 
alarmlRPNotif .xsd"> 

<xe : header> 

<xe;objectInstance>String</xe: object Instance> 
<xe:notificationId>21474 83 647</xe:notificationId> 
<xe:eventTime>2001-12-17T09:30:47. OZ</xe : eventTime> 
<xe ; systemDN>String</xe ; systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe ; header> 
<body> 

<alarmType>Communications Alarm</alarmType> 
<probableCause>Indeterminate</probableCause> 
<perceivedSeverity>Critical</perceivedSeverity> 
<comments> 

<comment> 

<conimentDate>2 001-12-17T0 9 : 30:47. OZ</commentDate> 
<comment Text > St ring</ comment Text > 
<userId>String</userId> 
<systemId>String</systemId> 
</ comment > 
</comments> 

<alarmId>String</alarmId> 
</body> 
</xe;Notification> 
</notif icationLogRecord> 
<notif icationLogRecord> 
<logRecordId/> 

<xe : Notification xsi ; type="Notif yPotentialFaultyAlarmList " 
xmlns="http ; //www. 3gpp . org/ftp/specs/archive/32_series/32 . lll-5#alarmIRPNotif " 
xsi : schemaLocation="http ; //www. 3gpp . org/ ftp/ specs /archive /32_series/ 32 . lll-5#alarmIRPNotif 
alarmlRPNotif .xsd"> 

<xe : header> 

<xe : object Inst ance> St ring</xe: object Inst ance> 
<xe:notificationId>21474 83 647</xe:notificationId> 
<xe:eventTime>20 1-12-1710 9:30: 47. OZ</xe:eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe : header> 
<body> 

<reason> 

<predef ined>Agent NE Communications Error</predef ined> 
</reason> 
</body> 
</xe:Notification> 
</notif icationLogRecord> 
</notif icationLogRecords> 
</notificationLog> 
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Annex C (informative): 

NL IRP XIVIL schema electronic files 

The electronic files corresponding to the normative XML schemas defined in the present document are available in 
native form in the following archive: 

http://www.3gpp.org/ftp/specs/archive/32_series/32.335/schema/32335-620-XMLSchema.zip 
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Annex D (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Cat 


Old 


New 


Sep 2004 


S 25 


SP-040564 


-- 


-- 


Submitted to TSG SA#25 for Information 


-- 


1.0.0 




Jun 2005 


S 28 


SP-050291 


-- 


-- 


Submitted to TSG SA#28 for Approval 


-- 


2.0.0 


6.0.0 


Mar 2006 


SA 31 


SP-060091 


0001 


-- 


Correct a validating error in notificationLog.xsd 


F 


6.0.0 


6.1.0 


Dec 2006 


SA 34 


SP-060709 


0002 


- 


Correct XML schema 


F 


6.1.0 


6.2.0 
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